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Preface 


Intended Audience 

This manual is intended for VAX/VMS system managers, operators, and 
system programmers. 


Structure of This Document 

This document is composed of three major sections. 

The Format Section is an overview of DISKQUOTA and is intended as a 
quick reference guide. The format summary contains the DCL command 
that invokes DISKQUOTA, listing all commands and qualifiers. The usage 
summary describes how to invoke and exit from DISKQUOTA, how to direct 
output, and any restrictions you should be aware of. 

The Description Section explains how to use DISKQUOTA. 

The Command Section describes each DISKQUOTA command. Commands 
appear in alphabetical order. 


Associated Documents 

For additional information on the topics covered in this document, refer to 
the VAX/VMS DCL Dictionary and the Guide to VAX/VMS System Management 
and Daily Operations . 


Conventions Used in This Document 


Convention 

(ret] 

ICTRL/xl 

$ SHOW TIME 
05-JUN-1985 11:55:22 

$ TYPE MYFILE.DAT 


file-spec,... 


Meaning 

A symbol with a one- to three-character abbreviation 
indicates that you press a key on the terminal, for 
example, I RET I . 

The phrase CTRL/x indicates that you must press 
the key labeled CTRL while you simultaneously press 
another key, for example, CTRL/C, CTRL/Y, CTRL/O. 

Command examples show all output lines or 
prompting characters that the system prints or 
displays in black letters. All user-entered commands 
are shown in red letters. 

Vertical series of periods, or ellipsis, mean either 
that not all the data that the system would display in 
response to the particular command is shown or that 
not all the data a user would enter is shown. 

Horizontal ellipsis indicates that additional parameters, 
values, or information can be entered. 
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Preface 


Convention 

Meaning 

[logical-name] 

Square brackets indicate that the enclosed item is 
optional. (Square brackets are not, however, optional 
in the syntax of a directory name in a file specification 
or in the syntax of a substring specification in an 
assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer to double 
quotation marks ("). The term apostrophe (') is used 
to refer to a single quotation mark. 
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New and Changed Features 

There are no technical changes in the Disk Quota Utility for VAX/VMS 
Version 4.0. 
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DISK QUOTA 

Description 


MODIFY 

/PERMQUOTA 

=quota 

/OVERDRAFT 

=quota-plus 

REBUILD 

REMOVE 

SHOW 

USE 


DESCRIPTION You use the Disk Quota Utility to allocate disk volume space to users. Table 

DQT-1 summarizes the DISKQUOTA commands by format and function. 

Table DQT-1 DISKQUOTA Command Summary 


Command 

Function 

ADD 

Adds an entry to the quota file 

CREATE 

Creates a quota file for a volume that does not currently 
contain one 

DISABLE 

Suspends quota operations on a volume 

ENABLE 

Resumes quota operations on a volume 

EXIT 

Returns the user to DCL command level 

HELP 

Lists the DISKQUOTA commands 

MODIFY 

Changes an entry in the quota file 

REBUILD 

Reconstructs the usage counts for all entries 

REMOVE 

Deletes an entry from the quota file 

SHOW 

Displays quotas and usage counts 

USE 

Specifies the volume to be acted upon 


1 Creating a New Quota File 

The sequence of commands for creating a new quota file usually includes: 

1 USE—To name the volume (can be omitted if the volume is the user's 
default device) 

2 CREATE—To create the quota file 

3 MODIFY—To set the quota and overdraft for UIC [0,0] 

4 REBUILD—To add entries for existing files (can be omitted on an empty 
volume) 

5 ADD—To add entries (one ADD command per entry) for UICs not 
automatically added during Step 4 

The sequence of commands for modifying an existing quota file typically 

includes (1) a USE command followed by (2) an ADD, MODIFY, or REMOVE 

command for each entry being changed. 
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DISK QUOTA 

Description 


2 Error Messages 

The VAX/VMS System Messages and Recovery Procedures Reference Manual lists 
messages issued by the Disk Quota Utility, and provides explanations and 
suggested user actions. 
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DISK QUOTA 

Commands 


COMMANDS This section describes DISKQUOTA commands and provides examples 

their use. 
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DISK QUOTA 

ADD 


ADD 

Adds an entry to the quota file. The usage count for a new entry is 
initialized to zero. The ADD command requires write access to the 
quota file. 

FORMAT 

ADD uic 

command 

parameter 

uic 

Specifies the user identification code (UIC) for which the quota entry is added. 
You can specify the UIC in numeric or alphanumeric format. (For complete 
information on UIC specification, refer to the VAX/VMS DCL Dictionary.) 

command 

qualifiers 

/PERMQUOTA=quota 

Specifies a positive integer that provides the quota for the specified UIC. If 
you omit the quota value, the quota defaults to the value of the quota in the 
entry for [0,0]. 

/OVERDRAFT=quota-plus 

Specifies a positive integer that provides an overdraft value for the specified 
UIC. If you omit the quota-plus value, the overdraft value defaults to the 
quota-plus in the entry for [0,0]. 


EXAMPLE 

DISKQ> ADD [300,211] /PERMQU0TA=200/0VERDRAFT=50 

The command in this example sets the quota for UIC [300,211] to 200 and the 
overdraft to 50 (for an absolute limit of 250 blocks). 
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DISK QUOTA 

CREATE 


CREATE 

Creates a quota file for a volume that does not currently contain one. 

FORMAT 

CREATE 

command 

parameters 

None. 

command 

qualifiers 

None. 

DESCRIPTION 

A quota file must not already be present on the volume being used. The 
CREATE command should be immediately followed by a MODIFY command 
for UIC [0,0] with quota and overdraft set to reasonable default values. 

The CREATE command requires write access to the volume's master file 
directory (MFD), as well as one or more of the following: SYSPRV privilege, 
a system UIC, or ownership of the volume. 

EXAMPLE 


DISKQ> CREATE 

The command in this example creates a new quota file. 


DQT-6 








DISK QUOTA 

DISABLE 


DISABLE 

Suspends the maintenance and enforcement of quotas on a volume. 

Use of the DISABLE command requires one or more of the 
following: the SYSPRV privilege, a system UIC, or ownership of 
the volume. 

FORMAT 

DISABLE 

command 

parameters 

command 

qualifiers 

None . 

None. 

EXAMPLE 



DISKQ> DISABLE 


The command in this example suspends quota enforcement. 
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DISK QUOTA 

ENABLE 


ENABLE 

Resumes quota enforcement on a volume. 

Use of the ENABLE command requires one of the following: the 

SYSPRV privilege, a system UIC, or ownership of the volume. 

FORMAT 

ENABLE 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


DISKQ> ENABLE 

The command in this example resumes quota enforcement. 
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DISK QUOTA 

EXIT 


EXIT 

Returns the user to DCL command level. 

FORMAT 

EXIT 

command 

parameters 

None. 

command 

qualifiers 

None. 

EXAMPLE 


DISQ> EXIT 

The command in this example terminates the DISKQUOTA session and 
returns control to the DCL level. 


DQT-9 


DISK QUOTA 

HELP 


HELP 

The HELP command lists and explains the DISKQUOTA commands. 

FORMAT 

HELP [command] 

command 

parameters 

command 

Specifies the name of a DISKQUOTA command. 

command 

qualifiers 

None. 


EXAMPLE 

DISKQ> HELP ENABLE 
ENABLE 

Enable diskquotas on the default volume. The default volume may 
be selected by issuing the USE command. Once a quota file is created 
on a volume, disk quotas are assumed enabled until explicitly 


disabled. 

FORMAT: 

ENABLE 

The command in this example displays information about the ENABLE 
command. 
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DISK QUOTA 

MODIFY 


MODIFY 

Changes an entry in the quota file. The MODIFY command requires 
write access to the quota file. 

If the disk quota is less than the current usage count, a warning 
message is issued. (The new quota does take effect, however.) 

FORMAT 

MODIFY uic 

command 

parameter 

uic 

Specifies the user identification code (UIC). You can specify the UIC in 
numeric or alphanumeric format. (For complete information on UIC specifica¬ 
tion, refer to the VAX/VMS DCL Dictionary.) 

command 

qualifiers 

/PERMQUOTA=quota 

Specifies a positive integer that provides the quota for the specified UIC. If 
you omit the quota value, the quota defaults to the value of the quota in the 
entry for [0,0]. 

/OVERDRAFT=quota-plus 

Specifies a positive integer that provides an overdraft value for the specified 
UIC. If you omit the quota-plus value, the overdraft value defaults to the 
quota-plus in the entry for [0,0]. 


EXAMPLE 

DISKQ> MODIFY [300,211] /PERMQU0TA^300 

The command in this example sets the permanent quota for UIC [300,211] to 
300 blocks, while making no change to the overdraft. 
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DISK QUOTA 

REBUILD 


REBUILD 

Reconstructs the usage counts for all entries on the volume. 

FORMAT 

REBUILD 

command 

parameters 

None. 

command 

qualifiers 

None. 

DESCRIPTION 

The REBUILD command automatically adds entries for files owned by UICs 
with no entries in the quota file, setting their quotas and overdrafts to the 
values of the defaults in UIC [0,0]. While the REBUILD command is ex¬ 
ecuting, file activity on the volume is frozen—no files can be created, 
deleted, extended, or truncated. For this reason, the command should be 
used judiciously, normally in the following situations: 


• Establishing a quota file—When a quota file is created on a volume with 
existing files, the REBUILD command should be run before the ADD 
command. REBUILD adds entries and records the existing usage for all 
UICs with detected usage. 


• Reenabling disk quotas—If usage counts have not been updated for some 
period because of suppression or suspension of the DISKQUOTA feature, 
REBUILD should be run to correct the usage. 

The REBUILD command requires write access to the quota file, as well as one 
of the following: the SYSPRV privilege, a system UIC, or ownership of the 
volume. 


EXAMPLE 


DISKQ> REBUILD 


The command in this example reconstructs the usage counts for all entries on 
the volume. 
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DISK QUOTA 

REMOVE 


REMOVE 

Deletes an entry from the quota file. The REMOVE command 
requires write access to the quota file. 

If the usage count for the UIC is not zero, a warning message 
is issued. (The UIC is removed, however.) UIC [0,0] cannot be 
removed. 

FORMAT 

REMOVE uic 

command 

UIC 

parameter 

Specifies the user identification code (UIC). You can specify the UIC 
in numeric or alphanumeric format. (For complete information on UIC 
specification, refer to the VAX/VMS DCL Dictionary.) 

command 

qualifiers 

None. 

EXAMPLE 



DISKQ> REMOVE [300,211] 


The command in this example deletes UIC [300,211] from the quota file. 


DISK QUOTA 

SHOW 


SHOW 



Displays quotas, overdrafts, and usage counts. 

Use of the SHOW command requires no privileges to show one's 
own quota, overdraft, and usage count, but otherwise requires read 
access to the quota file. 

FORMAT 

SHOW uic 

command 

parameters 

uic 

Specifies the user identification code (UIC). You can specify the UIC 
in numeric or alphanumeric format. (For complete information on UIC 
specification, refer to the VAX/VMS DCL Dictionary .) 

You can use an asterisk wildcard character (♦) to specify the UIC as follows: 

Command Description 

SHOW [300,211] Show user 211 in group 300 

SHOW [300,*] Show all users in group 300 

SHOW [*,211] Show all users with a member number of 211 

SHOW [*,*] Show all users 

command 

qualifiers 

None. 

EXAMPLE 


DISKQ> SHOW [360.*] 

The command in this example displays quotas, overdrafts, and usage counts 
for all users in group 360. 
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DISK QUOTA 

USE 


O 


USE 

Specifies the volume to be acted upon. 

FORMAT 

USE device 

command 

parameter 

device 

Specifies the physical or the logical name of the device for which disk quotas 
are being set. 


If USE is not specified, DISKQUOTA uses the user's default device. USE 
can be specified more than once during a session to work with quota files on 
more than one volume. 


Any volume in a volume set can be specified. The volume actually operated 
on, however, is relative volume 1. 

command 

qualifiers 

None. 


EXAMPLES 

Q DISKQ> USE DMA2: 

This command specifies the device by its physical name, DMA2:. 




g DISKQ> USE X2_RESEARCH_DATA 

This command specifies the logical name of the physical device. 
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